home *** CD-ROM | disk | FTP | other *** search
/ MacFormat 1995 January / macformat-020.iso / Shareware City / Developers / Commander Sets / 4D Speech Pack / 4D Speech Pack.rsrc / TEXT_13905_†SP Set Attr.txt < prev    next >
Encoding:
Text File  |  1994-09-14  |  2.0 KB  |  37 lines

  1. SP Set Attr (reference; rate; pitch) -> err
  2.  
  3. reference   integer       specifys the channel you want to use. Use
  4.                                     the reference number obtained from the
  5.                                     SP Open Voice function. The channel must be
  6.                                     open.
  7. rate            integer      the rate in Words per Minute (WPM) which needs
  8.                                    to be applied to the voice. The normal rate of the
  9.                                    voice is not changed if you pass a zero value.
  10.                                    The rate is usually between 150 WPM to around
  11.                                    180 WPM.
  12. pitch           integer      the pitch in Hertz (Hz) which needs to be applied
  13.                                     to the voice. The normal pitch of the voice is not
  14.                                     changed if you pass a zero value.
  15.                                     The pitch is usually between 90 Hz to 300 Hz.
  16. err             integer       returns the error which occured. 
  17.                                     A value of zero indicates no error occured. See 
  18.                                     below for a list of possible errors.
  19.  
  20. Set the rate and pitch of the specified voice.
  21.  
  22. The rate and pitch you specify may not be in the range for the speech synthesizer behind this voice. It is then changed to the nearest possible value by the speech synthesizer. The rate and pitch parameters are not changed to reflect the real values as they are set after using SP Set Attr. You can call SP Get Attr to get the corrected values.
  23. See for more information the Speech Manager documentation or use values obtained by using the SP Get Attr function to modify a voice.
  24.  
  25. Examples:
  26.   $err := SP Set Attr ($speechref;$rate+5;$pitch+15)
  27.   $err := SP Set Attr ($speechref;150;175)
  28.  
  29. Possible errors:
  30.         0  No Error
  31.       -4  Speech Pack can not be used (Speech Mgr not available)
  32. -3000  Invalid SpeechChannel parameter, probably invalid reference
  33.             number
  34.  
  35.  
  36.  
  37.